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data persistence. 



MySQL: 


This is the second article in a series of articles on 
GlassFish and MySQL. Part 1 of the series describes 
the advantages of using GlassFish with MySQL and 
illustrates why the combination is a perfect choice for 
developing and deploying web applications. In Part 2, 
you'll learn how to develop a create, read, update, 
delete (CRUD) web application that uses GlassFish 
and MySQL. The application uses the Java 
Persistence API implemented in GlassFish to manage 


An important characteristic of both GlassFish and MySQL is that they're easily integrated into popular development tools. For 
example, plug-ins are available for both GlassFish and MySQL to integrate them into the NetBeans IDE and the Eclipse IDE. In 
addition, NetBeans IDE 6.1 With GlassFish and MySQL Bundle Download is available that integrates GlassFish v2 Update 
Release 2 (UR2) and MySQL 5.0 Community Server into NetBeans IDE 6.1. You can also download GlassFish v2UR2 with 
either NetBeans IDE 6.1 or NetBeans IDE 6.5 in a single bundle. A precursor to the next version of GlassFish, called the 
GlassFish v3 Prelude, is also available with NetBeans IDE 6.5. 


This article shows you how to use the NetBeans IDE with GlassFish and MySQL to create the CRUD application. Specifically, 
you'll take advantage of features in NetBeans IDE 6.5, GlassFish v2UR2, and MySQL 5.1 Community Server to build and 
deploy the application. 

You can examine the completed CRUD application by downloading and expanding the petcatalog application package. 

Contents 

- The Application 

- Inside the Application 

- Building the Application 

- Summary 

- For More Information 

The Application 

The application for this article allows users to search an online catalog of pets. For example, users can search for a specific 
type of pet, such as medium-sized dogs, and display information about the items of that type in the catalog. Figure 1 shows a 
page that the application displays with this type of information. 
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Product Detail 


Name: Medium Dogs 


Description: 

Product: 


Friendly dog from England 



Category: Dogs 

ItemCollection: 


Name 


Photo 


Price 


Beach Dog 


Scrapper Dog 



250.00 


Show Edit Destroy 


Intense Worker Dog 



257.00 Show Edit Destroy 


500.00 


Show Edit Destroy 


Figure 1. Medium-Sized Dogs in the Catalog 


Retrieving information from the catalog represents the read or R capability of the CRUD application. As Figure 2 shows, a user 
can create a new item and add it to the catalog. This represents the application's create or C capability. 
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New Product 


Id: 

Name: 

Description: 

Imageurl: 

Category: 


155 


Super Dog 


A heroic dog 


/images/smithy.jpg 


model.Category[id=2] v 


ItemCollection: 


model.Item[id=1] 
model.Item[id=2] 
model.Item[id=3] 
model.ltem[icM] 
model.Item[id=5] 
model.Item[id=6] 


Create 


Show All Froduct Items 

Index 


Figure 2. Creating a New Item 

A user can also edit an entry in the catalog. This demonstrates the application's update or U capability. A user can also delete 
an entry. This demonstrates the application's delete or D capability. 

Inside the Application 

Before building the application, let's examine the components of the completed application. If you haven't already done so, 
download and expand the petcatalog application package. 

The Catalog 

Central to the application is the catalog, which is contained in a MySQL database named petcatalog. The petcatalog 
database has four tables: 

♦ category. Contains information about each item category in the catalog, such as dogs. For each category, the table 
contains an identification (ID) number, name, description, and URL of a representative image. 

♦ product . Contains information about each product type within a category, such as medium dogs or small dogs. For each 
product, the table contains an ID number, product ID number, name, description, and URL of a representative image. 

♦ item. Contains information about each item in the catalog, such as beach dog. For each item, the table contains an ID 
number, product ID number, name, description, URL of the item's image, URL of the item's thumbnail image, price, and 
address ID. 

♦ address. Contains information about the address of each item in the catalog. The address includes street, city, state, zip 
code, latitude, and longitude. 

For example, here are the contents of the c a t e g o ry table: 


id 

- +-+ - 

| name | 

-+. 

description | 

imageurl 




' 


1 

| Cats | 

Loving 

and finicky friends | 

/images/cats_icon.gif 

2 

1 Dogs | 

Loving 

and furry friends | 

/images/dogs_icon.gif 

3 

| Birds | 

Loving 

and feathery friends | 

/images/birds_icon.gif 

4 

| Reptiles | 

Loving 

and scaly friends | 

/images/reptiles_icon.gif 

5 

| Fish | 

- +-+ ■ 

Loving 

aquatic friends | 

-+. 

/images/fish_icon.gif 


You will find a file named catalog.sqi in the petcatalog application . The file contains the SQL statements that create the 
tables and fill them with data. For example, here are the SQL statements that create the ca t egory table and fill it with data: 
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create table category( 
id BIGINT NOT NULL, 
name VARCHAR(25) NOT NULL, 
description VARCHAR(255) NOT NULL, 
imageur1 VARCHAR(BB), 
primary key (id) 

) ; 


INSERT INTO category VALUES(1, 
INSERT INTO category VALUES(2, 
INSERT INTO category VALUES(3, 
INSERT INTO category VALUES(4, 
INSERT INTO category VALUES(5, 


'Cats', 'Loving and finicky friends', 1 /images/cats_icc 
'Dogs', 'Loving and furry friends', 1 /images/dogs_icon. 
'Birds', 'Loving and feathery friends', 1 /images/birds_ 
'Reptiles', 'Loving and scaly friends', 1 /images/repti] 
'Fish', 'Loving aquatic friends', 1 /images/fish_icon . gi 


This demonstrates how easy it is in MySQL to create database tables and fill them with 
content. You manage and query databases in MySQL using ANSI standard SQL, a 
language that many users find easy to use because of its relatively straightforward 
syntax. 

Model-View-Controller 

If you further examine the completed application, you'll notice that it follows the model-view-controller (MVC) design pattern. 
That is, the application isolates its data, known as the model, from the user interface or view, and from the code that manages 
the communication between the model and the view, known as the controller. You'll find the model and the controller in the 
src/j ava directory of the application. You'll find the view in the web directory. 

Let's first look at the model for the application. 


It's easy to manage and query 
databases in MySQL using 
SQL. 


The Model 

The model not only represents the data for the application, but it also represents 
persistent data, that is, data that persists beyond the life of the application. In other 
words, the model represents an application's persistent business domain objects. One of 
the advantages of using GlassFish as the application server for this application is that it 
includes a built-in persistence manager, the Java Persistence API based on Toplink 
Essentials. Taking advantage of this feature, the application uses the Java Persistence 
API to manage data persistence. 


One of the advantages of using 
GlassFish as the application 
server for this application is that 
it includes a built-in persistence 
manager, the Java Persistence 
API. 


If you open the mode 1 directory, you will see various Java classes. Four of these classes, Address, Category, item, and 
Product, are entity classes -- typical Java Persistence API entity objects -- for the four tables in the pet cat a 1 og database. In 
the Java Persistence API, an entity instance, an instance of an entity object, represents a row of data in a database table. For 
example, item is an entity class that maps to the item table in the pet catalog database. An instance of the item entity 
represents a row of data in the item table. Here is part of the source code for the item class: 
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package model; 

import java.io.Seri a 1izab1e; 


@Entity 

@Table(name = "item") 

public class Item implements Serializable { 

private static final long seriaIVersionUID = 1L; 

@Id 

@Basic (optional = false) 

^Column(name = "id") 

private Long id; 

@Basic (optional = false) 

^Column(name = "name") 
private String name; 

@Basic (optional = false) 

^Column(name = "description") 
private String description; 

^Column(name = "imageurl") 
private String imageurl; 

^Column(name = "imagethumburl") 
private String imagethumbur1; 

@Basic(optional = false) 

^Column(name = "price") 
private BigDecimal price; 

@JoinColumn(name = "address_id " , referencedCo1umnName = "id") 

@ManyToOne 

private Address address; 

@JoinCo1umn(name = "product_id", referencedCo1umnName = "id") 

@ManyToOne 

private Product product; 

//getters and setters 


Notice the @ManyToOne annotations in the item class. These specify that the item class has a many-to-one relationship with 
the Address class and a many-to-one relationship with the Product class. This means that there can be multiple items in the 
catalog associated with the same address or with the same product type. 

Conversely, the Address and Product classes have a one-to-many relationship with the Address class. This means that an 
item cannot be associated with multiple addresses or multiple product types. The one-to-many relationship is specified in 
@0neToMany annotations in the Address and Product entity classes. Here is the one-to-many annotation in the Address 
class: 


@0neToMany(cascade = CascadeType.ALL, mappedBy = "address") 


Here is the one-to-many annotation in the Product class: 


@0neToMany(cascade = CascadeType.ALL, mappedBy = "product") 


Annotations are an important Java EE 5 usability enhancement that is implemented in 
GlassFish. The Java Persistence API is only one of the technologies implemented in 
GlassFish that supports the use of annotations. In the CRUD application, annotations 
simplify the code for objects such as entity classes, enabling you to code these objects 
as Plain Old Java Objects (POJOs). 

The model directory also contains controller and converter classes. Each controller class 
invokes methods in Java Persistence API controller classes to perform operations for a 
corresponding entity class, such as creating and editing an instance of the entity class. 
Java Persistence API controller classes are in the controller layer of the application. For 
example, the following method in the i temController class invokes the create () 


Annotations are an important 
Java EE 5 usability 
enhancement that is 
implemented in GlassFish. 
Using annotations in the Java 
Persistence API simplifies the 
code for entity classes, 
enabling you to code these 
objects as Plain Old Java 
Objects (POJOs). 
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method in the i temJpaContro 11 er class to create an instance of the item class: 


private ItemJpaContro11er jpaContro11er = null; 

public String create ( ) { 

try { 

jpaController.create(item); 

JsfUtil.addSuccessMessage("Item was successfully created."); 

} catch (Exception e) { 

JsfUtil.ensureAddErrorMessage(e, "A persistence error occurred."); 
return null; 

} 

return listSetupf); 

} 


The converter classes use JavaServer Faces technology (often referred to as JSF) to convert instances of the corresponding 
entity class to s t r i n g objects, or the reverse --string objects to entity classes. For example, the following method in the 
itemConverter class converts an instance of the item class toastnng object: 


public Object getAsObject(FacesContext facesContext, UlComponent component. String sti 
if (string == null || string.1ength() == 0) { 

return null; 

} 

Long id = new Long(string); 

ItemJpaContro11er controller = (ItemJpaContro11er) facesContext.getApplicatior 

return controller.findltern(id); 


JavaServer Faces technology also plays an important role in the view layer of the application. 

The Controller 

The controller directory contains Java Persistence API controller classes. Each of these classes uses the Java Persistence 
API to handle operations for the corresponding entity class, such as creating and editing instances of the entity class. For 
example, here is part of the create method in the i temJpaContro 11 er that creates an instance of the item entity class: 


public void create(ltem item) throws PreexistingEntityException, Ro11backFai1ureExcept 
EntityManager em = null; 
try { 

utx . begin(); 

em = getEntityManager(); 

Address address = itern.getAddress(); 
if (address != null) { 

address = em.getReference(address.getClass(), address.get Id()); 
itern.setAddress(address); 

} 

Product product = itern.getProduct(); 
if (product != null) { 

product = em.getReference(product.getClass(), product.get Id()); 
itern.setProduct(product); 

} 

em.persist(item); 
if (address != null) { 

address.getItemCo11ection().add(item); 
address = em.merge(address); 

} 

if (product != null) { 

product.getItemCo11ection().add(item); 
product = em.merge(product); 

} 

utx . commit(); 


The View 

The view layer uses data from domain objects provided by the controller to generate a 
web page. The view is rendered in the application using JavaServer Pages (JSP) 


GlassFish implements Java EE 
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technology and JavaServer Faces technology. JSP enables the dynamic content required 
by the application, and JavaServer Faces technology provides Ul components for the 
application. These are only two of a number of Java EE web technologies supported by 
GlassFish that provide simple, consistent mechanisms for extending web applications 
beyond static web pages. 


web technologies such as JSP 
and JavaServer Faces 
technology that provide simple, 
consistent mechanisms for 
extending web applications 
beyond static web pages. 


If you navigate to the web/product directory in the pet cat a log application, you'll see 

a file named List, j s p . This file provides one example of how JSP and JavaServer Faces technology are used in the 
application, l i st. j sp is the JSP page that displays the types of products in the catalog, as shown in Figure 3. 


Catalog Products 


Item 1 .5 of 10 Next 5 

Name Description Photo Category 


Hairy Cat 


Groomed 

Cat 


Medium 

Dogs 


Great for reducing mouse populations 


Friendly house cat keeps you away from the 
vacuum 


Friendly dog from England 




Figure 3. Catalog Products Page 
Click the image to enlarge it and show an additional column. 


Here is part of the code inList.jsp: 


<%@taglib uri = "http ://jQva .sun.com/jsf/core" pref ix = "f " %> 

<%@taglib uri="http://java.sun.com/jsf/html" prefix="h" %> 

< f:view> 

< html> 

< body> 

<h messages errorSty 1 e = " co 1 or : red" inf oStyle = "color : green" 1 ayout = " t ab 1 e 11 /> 
<hl>Catalog Products</h1> 

<h:dataTable va1ue = "#{product.product Iterns}" var="iteml" border="0" cellpadc 
<h : column> 

<f:facet name="header"> 

<h : outputText va1ue = "Name"/> 

</f:facet> 

<h : outputText value = " #{ i tem 1 . name } 11 /> 

</h:column> 


The tags prefixed by f or h are JavaServer Faces technology tags. Notice especially the d a t aTa b 1 e tag. This tag is used to 
create a table and render it on the page. The tag is useful when you want to show a set of results in a table format. In an 
application that uses JavaServer Faces technology, the ui Data component, the superclass of dataTabie, supports binding 
to a collection of data objects. It does the work of iterating over each record in the data source -- in this case, the catalog. The 
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HTML Tenderer for d a t aTa b 1 e displays the data as an HTML table. 

The value attribute of the dataTabie tag references the data to be included in the table. The var attribute specifies a name 
that is used by the components within the dataTabie tag as an alias to the data referenced in the value attribute. Here, the 
va 1 ue attribute points to a list of items in the product table in the catalog. The var attribute points to a single item in that list. 
As the ui Data component iterates through the list, each reference to i tem 1 points to the current item in the list. 

Notice too that the name, description, photo, and category of each item -- as well as show, edit, and destroy action links -- are 
displayed with JavaServer Faces technology column tags. The column tags represent columns of data in a ui Data 
component. While the ui Data component iterates over the rows of data, it processes the uicoiumn component associated 
with each column tag for each row in the table. The ui Da t a component iterates through the list of items, 
product. product i tems, and displays the names, photos, and prices. Each time ui Data iterates through the list of items, it 
renders one cell in each column. 

The dataTabie and coi umn tags use facet tags to represent parts of the table that are not repeated or updated. These 
include headers, footers, and captions. 

Building the Application 

At this point, you might think that the CRUD application is fairly complicated and requires 
a lot of coding. As you build the application, you'll see that a lot of the coding is 
automatically generated by the NetBeans IDE. 

Here's how to build the application. 

1. If you haven't already done so, download and install NetBeans IDE 6.5, GlassFish v2UR2, and MySQL Community Server 
5.1. You can download and install GlassFish v2UR2 with NetBeans IDE 6.5 as a single bundle. 

2. Start the NetBeans IDE. 

3. Ensure that GlassFish is registered in the NetBeans IDE, as follows: 

♦ Click the Services tab in the NetBeans IDE. 

♦ Expand the Servers node. You should see GlassFish v2 in the list of servers. If not, register GlassFish v2 as follows: 

♦ Right-click the Servers node and select Add Server. This opens an Add Server Instance wizard. 

♦ Select GlassFish v2 in the server list of the wizard and click the Next button. 

♦ Enter the location information for the server and click the Next button. 

♦ Enter the admin name and password and click the Finish button. 

4. Start the MySQL database as follows: 

♦ Click the Services tab in the NetBeans IDE. 

♦ Expand the Databases node. You should see the MySQL server database in the list of databases, as shown in Figure 
4. 


A lot of the coding for the 
CRUD application is 
automatically generated by the 
NetBeans IDE. 


: Projects 


: Files 


iSery... 4W x 


©■ 


Databases 

9 


06 [root] 


Figure 4. MySQL Server Database in the 
Database List 


Note that the MySQL Connector/J JDBC Driver, which is necessary for 

communication between Java platforms and the MySQL database protocol, is The MySQL Connector/J 

included in NetBeans IDE 6.5. JDBC Driver, which is 

necessary for communication 

5. Set the properties of the MySQL server database as follows: between Java platforms and 

♦ Right-click on the MySQL server database and select Properties. This opens the the MySQL database protocol, 
MySQL Server Properties dialog box, as shown in Figure 5. is included in the NetBeans 

IDE. 
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Figure 5. MySQL Server Basic Properties 


♦ In the Basic Properties tab, enter the server host name and port number. The IDE specifies locaihost as the 
default server host name and 3 3 o 6 as the default server port number. 

♦ Enter the administrator user name, if not displayed, and the administrator password, the default administrator 
password is blank. 

♦ Click the Admin Properties tab. 

♦ Enter an appropriate path in the Path/URL to admin tool field. You can find the path by browsing to the location of a 
MySQL Administration application such as the MySQL Admin Tool. 

♦ Enter an appropriate path in the Path to start command. You can find the path by browsing to the location of the 
MySQL start command. To find the start command, look for mysq l d in the b i n folder of the MySQL installation 
directory. 

♦ Enter an appropriate path in the Path to stop command field. You can find the path by browsing to the location of the 
MySQL stop command. This is usually the path to mysq l admin in the b i n folder of the MySQL installation directory. 
If the command is mysq l admin , in the Arguments field, type - u root stop to grant root permissions for stopping 
the server. The Admin Properties tab should look similar to Figure 6. 
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Figure 6. MySQL Server Administration Properties 


♦ Click the OK button. 

6. Right-click on the MySQL server database and select Start. 

7. Create the petcatalog database as follows: 

♦ Right-click on the MySQL server database and select Create Database. 

♦ Enter the database name p e t c a t a l o g . This will open a New Database Connection dialog box. Click OK to accept 
the displayed settings. 

8. Create the tables in the MySQL pet-catalog database as follows: 

♦ Expand the Drivers node. You should see a driver for the p e t c a t a l o g database in the list of drivers, as shown in 

Figure 7. 


jdbc: my sql: //localhost: 3306/petcatalog 


Figure 7. Driver for the petcataios 
Database 


♦ Right-click the petcatalog driver and select Connect. 

♦ Right-click the petcatalog driver and select Execute Command. This will open an SQL command window. 

♦ Copy the contents of the catalog, sqi file and paste the contents into the SQL editor, as shown in Figure 8. 


Connection: 


jdbc:mysql://localhost:... v 


a> ? 0 m ^ ^ 


create table category ( 
id ETGTNT NOT NULL, 
name VARCHAR (25) NOT NULL, 
description VARCHAR (255) NOT NULL, 
image ur 1 VARC HAP. (55), 
primary bey (id) 


CREATE TABLE product ( 
id BIGTNT NOT NULL, 
category_id BTGINT NOT NULL, 
name VARCHAR (25) NOT NULL, 
description VARCHAR (255) NOT NULL, 
image ur1 VARC HAR (55), 
primary bey (id), 

foreign bey (category_id) references category(id) 
); 

Figure 8. Creating Tables in the Database 


♦ Click the Run SQL icon ^ (Ctrl+Shift+E) in the SQL toolbar above the SQL editor. 

You can view the tables you just created. Right-click the Tables node below the petcatalog database in the 
Services window. You should see the database tables under the Tables node. You can expand a table node to see 
the table columns, indexes, and any foreign keys, as shown in Figure 9. 
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jdbc:mysql://localhost:3306/petcatalog [root on Default schema] 
£)■ _| Tables 
©"O address 
+ Q category 

slffi 


- 


0- 


lU id 

HD produetjd 
m name 
■E® description 
LU imageurl 
HD imagethumburl 
19 price 
[I® addressjd 

_| Indexes 

i-10 PRIMARY 
G£F[®j addressjd 
produetjd 

_| Foreign keys 

itemjbfk_l 
item ibfk 2 


A- 


HP 

+ |__] product 

_| Views 

_| Procedures 

Figure 9. An Expanded Table Node 


You can view the contents of a table or column by right-clicking the table or column and selecting View Data as shown 

in Figure 10. 


a-H 



]■■■' I Views 
]~CJ Proce 
^ jdbc:mys( 
| jdbc:mys( 
i/eb Services 
nterprise Be 
ervers 
GlassFish 


V2 


View Data... 


Add Column... 

Refresh 

Delete 

Grab Structure... 
Recreate Table... 

Properties 


Delete 


[root 
on De 


i; i in d 

select * from item x 


@ ■ £1 <3>K< >>T Page Size: 

20 

id produetjd name 

1 

1 

Friendly Cat 

2 

1 

Fluffy Cat 

3 

2 

Sneaky Cat 

4 

2 

Lazy Cat 

5 

1 

Old Cat 

6 

2 

Young Female 

7 

1 

Playful Female 

R 

1 

Whihfi Fli iffv r 

m _ m _11 


Figure 10. Viewing the Contents of a Table 


9. Create the web application project as follows: 

♦ Select New Project (Ctrl-Shift-N) from the File menu in the NetBeans IDE. This opens the New Project window. 

♦ In the New Project Window, select Java Web from the Categories list and Web Application from the Projects list. Click 
the Next button. This opens the Name and Location page of the New Project window. 

♦ Enter petcata l og in the Project name field and a project location in the Project Location field. Check the Set as 
Main Project checkbox. Click the Next button. This opens the Server and Settings page of the New Project window. 

♦ Specify GlassFish as the server and select Java EE 5 as the Java EE version. Click the Next button. This opens the 
Frameworks page of the New Project wizard. 

♦ Check the JavaServer Faces checkbox in the Frameworks panel. Click the Finish button. 

In response, the IDE creates the basic structure for the web application project, including an sre directory to hold the Java 
source files for the project, a web directory to hold the JSP and JavaServer Faces technology files for the project, and an 
nbproj ect directory to hold the metadata and build-related files for the project. 

10. Add the pet images to the project. Copy the images folder from the web directory in the completed petcataiog 

application to the web directory in the web application that you are building. You should see images in the web\images 
folder such as the African spurred tortoise shown in Figure 11 . 
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Figure 11. African Spurred Tortoise 


11. Generate entity classes from the database. One of the powerful features of NetBeans 
IDE 6.5 is that it enables you to quickly create Java Persistence API entity classes 
from tables in a database. Here's how to generate entity classes from the tables that 
you created in the MySQL database: 

♦ In the Projects tab, right-click the pet cats l og project node for the application 
and select New. Then select Entity Classes from Database. This opens the New 
Entity Classes from Database wizard. 

♦ Select New Data Source from the Data Source drop-down list. This opens the 
Create Data Source dialog box. 

♦ In the Create Data Source dialog, enter jdbc/petcataiog in the JNDI Name field 

j dbc : mysq1 : //localhost : 3306 /petcataiog from the Database Connection 
should look like those in Figure 12. 


One of the powerful features 
of the NetBeans IDE is that it 
enables you to quickly create 
Java Persistence API entity 
classes from tables in a 
database. 


and select 

drop-down list. Your entries 



Figure 12. Creating a Data Source 


Click the OK button to close the dialog box and display the Database Tables page of the wizard. The tables in the 
petcataiog database appear in the Available Tables listbox, as shown in Figure 13. 
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Figure 13. Selecting Tables to Generate Entity Classes 


♦ Click the Add All button in the Database Tables page. This moves the tables in the Available Tables listbox to the 
Select Tables listbox. Click the Next button. This opens the Entity Classes page of the New Entity Classes from 
Database wizard. 

♦ Enter mo d e l in the Package field. Make sure that the checkbox labeled Generate Named Query Annotations for 
Persistent Fields is selected. The Database Tables page should look as shown in Figure 14. 
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Figure 14. Specifying Tables and Entity Classes 


♦ Click the Create Persistence Unit button. This opens the Create Persistence Unit dialog box. Leave the entries as is 
and click the Create button in the dialog box to create the persistence unit and return to the Database Tables page of 
the wizard. 

♦ Click the Next button to open the Mapping Options page of the wizard. 

♦ Leave the default values in the Mapping Options page as is and click the Finish button. 

In response, the IDE generates an entity class for each table in the p e t c a t a l o g database. You can see this in the 
Projects tab of the IDE by expanding the Source Packages node for thepetcataiog project and then expanding the 
model node. This is shown in Figure 15. 


petcatalog 

(^■■|£qJ WebPages 
+ Configuration Files 
©••0§ Server Resources 
©••£S Source Packages 


model 


hfe ^Address .java 
[■■■■ \&.-> ^Category .java 
f -[^i^Item.java 
A Product .java 
+HQg Test Packages 
(|H£gi Libraries 
+ ^ Test Libraries 


Figure 15. New Entities Generated from 
Database Tables 


If you open each of the generated classes, you'll see that the IDE generated the Java code for the classes including all the 
needed annotations. 

12. Edit the entity classes. Although the IDE generates the entity classes for the application, the content of each class needs to 
be slightly modified to fit the requirements of the application. For example, in Address . j ava, the entity class for the 
address table, the @0neToMany annotation specifies a MappedTo parameter value of addressid. In this application, 
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the value needs to be changed to address. In i tem . j ava, the entity class for the item table, the @ManyToOne 
annotations specify the parameter (optional = false). This specifies that a non-null relationship must always exist in 
the relationship. For this application, let's not make that restriction. You can either change the @ManyToOne annotations to 
specify a parameter of (optional = true) or not declare the opt ionai parameter because a value of true is the 
default. 

Change each of the entity classes as follows: 

♦ Addre ss. j ava : 

Change: 


@OneToMany(cascade = CascadeType.ALL, mappedBy = "address Id") 


To: 


@OneToMany(cascade = CascadeType.ALL, mappedBy = "address") 


♦ Category.java: 

Change: 


@OneToMany(cascade = CascadeType.ALL, mappedBy = "categoryId") 


To: 


@OneToMany(cascade = CascadeType.ALL, mappedBy = "category") 


♦ Item.j ava: 

Change: 


@JoinCo1umn(name = "address_id", referencedCo1umnWame = "id") 
@ManyToOne(optiona1 = false) 
private Address addressld; 

@JoinCo1umn(name = "product_id", referencedCo1umnWame = "id") 
@ManyToOne(optiona1 = false) 
private Product productld; 


To: 


@JoinCo1umn(name = "address_id", referencedCo1umnWame = "id") 

@ManyToOne 

private Address address; 

@JoinCo1umn(name = "product_id", referencedCo1umnWame = "id") 

@ManyToOne 

private Product product; 


Change: 
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public Address getAddressId() { 

return addressld; 

} 

public void setAddressId(Address addressld) { 
this.addressld = addressld; 

} 

public Product getProductId ( ) { 

return productld; 

} 

public void setProductId(Product productld) { 
this.productld = productld; 

} 


To: 


public Address getAddress() 
return address; 


} 


{ 


public void setAddress(Address address) { 
this.address = address; 

} 


public Product getProduct() { 

return product; 

} 


public void setProduct(Product product) { 
this.product = product; 

} 


♦ Product.j ava : 

Change: 

@ManyToOne(optiona1 = false) 

private Category categoryld; 

@OneToMany(cascade = CascadeType.ALL, mappedBy = "productld 


To: 

@ManyToOne 

private Category category; 

@OneToMany(cascade = CascadeType.ALL, mappedBy = "product") 


Change: 

public Category getCategoryldf) { 
return categoryld; 

} 

public void setCategoryId(Category categoryld) { 
this.categoryId = categoryld; 

} 


To: 
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public Category getCategory() { 
return category; 

} 

public void setCategory(Category category) { 
this.category = category; 

} 


Make sure to save all your changes. 


13. Generate JavaServer Faces technology pages from the entity classes. NetBeans IDE 
6.5 not only enables you to quickly create Java Persistence API entity classes from 
tables in a database, it also enables you to generate JavaServer Faces technology 
pages, that is, JSP pages with JavaServer Faces technology components, from the 
entity classes. Here is how to generate JavaServer Faces technology pages from the 
entity classes: 

♦ Right-click the p e t c a t a l o g project node in the Projects window and select 
New. Then select JSF Pages from Entity Classes. This opens the New JSF 
Pages from Entity Classes wizard, as shown in Figure 16. 


The NetBeans IDE enables 
you to easily generate 
JavaServer Faces technology 
pages, that is, JSP pages with 
JavaServer Faces technology 
components, from entity 
classes. 



Figure 16. New JSF Pages From Entity Classes 


♦ Click the Add All button to move all the entity classes to the Select Entity Classes pane of the wizard. 

♦ Click the Next button to open the Generate JSF Pages and Classes page of the wizard. 

♦ Specify controller in the JPA Controller Package field and ensure that model is specified in the JSF Classes 
Package field, as shown in Figure 17. 


17 av 23 


2009-03-07 22:02 




































GlassFish and MySQL, Part 2: Building a CRUD Web Application Wit... http://java. sun. com/jsputi 1 s/PrintPage.jsp?ur 1 =http%3A%2F%2Fjava.s... 



Figure 17. Identifying the Controller and Model 


♦ You have the option to select the checkbox labeled Ajax-enable generated pages. 

♦ Click the Finish button. In response, the IDE creates acont roller package and generates Java Persistence API 
controller classes in that package for each entity class in the p e t c a t a l o g project. The IDE also creates a 
controller. exceptions package and generates in that package exception classes for entity-related exceptions. 

In addition, the IDE generates JavaServer Faces technology converter and JavaServer Faces technology controller 
classes in the model package. It also creates a mode l . util package and generates a number of utility classes 
such as a JSF Expression Language resolver in that package . 

Expand the Source Package node in the pet cat a l og project to see the new classes. This is shown in Figure 18. 
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- 11 petcatalog 

WebPages 
Configuration Files 
+ l2§ Server Resources 
Source Packages 

- [ _| controller 

f ■■■■ j&i ^Address JpaController. java 
[■■■■ |i%l ^Category JpaController. java 
[■■■■ fa^ltenriJpaController. java 
ifl-i Product JpaController. java 
I controller.exceptions 


model 


I I-address .java 

iff.-i ^AddressController. java 
f- - [^i^AddressConverter.java 
: A ^Category .java 
f ■■■■ ^CategoryController. java 

iff-i ^CategoryConverter. java 
h fasten, java 
[■■■■ [^l^ltemController.java 
[■■■■■ [^^temConverter. java 
hk ^Product .java 
f--1^1 ^ProductController. java 
i©.-i ^ProductConverter. java 
+ yj model.util 

Figure 18. Entity and Controller Classes 


Examine the contents of the Java Persistence API controller classes, JavaServer Faces technology converter classes, 
and JavaServer Faces technology controller classes. You'll see that the contents match those of the analogous 
classes in the completed petcatalog application. 

If you expand the Configuration Files node and open the faces-config.xmi file in the XML editor as shown in 
Figure 19, you'll see that the IDE inserted (managed-bean > and (converter) elements for each of the controller 
and converter classes. The IDE also inserted a <navigation-ruie> element for each JSP page, indicating the 
outcome that causes the application to navigate to that JSP page. 


PageFlow 


a 


i 


mi 


^ ^ % 


Cj| Oi 

Q □ 



Cmanaye d-b a an> 

<rtianage d-b a an- name > addr ess</ manage d-b a an- name > 
Cmanayed-b a an-class >mo da1.Addr essControllerc/ manage 


<manage d-b a an-s c□ pa > s a s sio n< / manage d-b e an- scopes 

< / manage d-b a an> 

<manage d-b a an> 

<managa d-b a an- name > addu a s s J p a< / manage d-b a an- name > 
Cmanaye d-b a an-clas s>controller.AddrassJpaCont roller 
cmanaye d-b a an-s c o p a > s a s sio n< / manage d-b a an-s c o p a > 

C/ managed-b e an> 

< c o nve r t a r > 

<convartar-f or-class>model.Address</convertar-f or-c 
<convartar-class>model .AddrassConvarter </ converter- 
</convartar> 

< navigation-r u1a > 

Cnavigation-case> 

c f rom-o ut c oma > addr a s s_c reatec/fr om-o utc oma > 
<to-viev-id>/address/New. jsp </ 1.o- v iav- id> 
c/ navigatio n-c as a > 

</ navigation-rule > 

Figure 19. The faces-confi#. xmi File 
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14. Edit the JSP pages. If you expand the Web Pages node, you'll see that the IDE also generated a folder for each of the 
entity classes. Each folder contains the files Detail.jsp, Edit, jsp, List, jsp, and New . j sp. The IDE also modified 
the w e1c ome JS F .jsp file by inserting links to each of the List. j sp pages. The IDE also created a Script file, 
jsfcrud.js, and a CSS file, jsfcrud.css. The Script file is used primarily to handle Ajax-related actions if you 
selected the Ajax-enable generated pages checkbox in the New JSF Pages from Entity Classes wizard. The CSS file 
controls the style attributes, such as color and font, used in the web pages. 

Although the contents of the JSP files are close to what the application requires, they still require modification. For 
example, the we 1 comeJSF .jsp page will display the heading "JavaServer Faces." You want it to display "Pet Catalog." In 
addition, the Beta 11 .jsp and List. j sp pages in the entity classes folders do not currently display the exact set of 
columns to be displayed. 

Here's what to change in the we icomeJSF . jsp page: 

Change: 

<title>JSP Page</title> 

<h1><h:ontputText va1ue="JavaServer Faces" /></hl> 


To: 


<title>Pet Cata1og</tit1e> 

<h1><h:outputText value="Pet Catalog" /></hl> 


You must compare the d e t a 11 .jsp and List, jsp pages in each of the entity class folders with their equivalents in the 
finished petcataiog application to identify the required changes. For example, here are the changes to make to the 
List .jsp file in the item folder: 

Change: 
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<ti11e>Listing Item I terns</ti11e> 

<hl>Listing Item Items</hl> 

< h:co1umn > 

<f:facet name="header"> 

<h:outputText va1ue="Id"/> 

</f:facet> 

<h:outputText value=" #{item1.id}"/> 

</h :co1umn> 

< h:co1umn > 

<f:facet name="header"> 

<h:outputText va1ue="Name"/> 

</f:facet> 

< h : outputText value = " #{ i tem 1 . name } '*/> 

</h :co1umn> 

< h:co1umn > 

<f:facet name="header"> 

<h:outputText value="Description "/> 

</f:facet> 

<h:outputText value=" #{item1.description}"/> 

</h :co1umn> 

< h:co1umn > 

<f : facet name="header"> 

<h:outputText value="Imageurl "/> 

</f:facet> 

<h:outputText value=" #{iteml.imageurl}"/> 

</h :co1umn> 

< h:co1umn > 

<f:facet name="header"> 

<h :outputText value="Imagethumburl " /> 

</f:facet> 

<h:outputText value=" #{item1.imagethumburl}"/> 
</h:column> 

< h:co1umn > 

<f:facet name="header"> 

<h:outputText va1ue="Price"/> 

</f:facet> 

<h:outputText value=" #{item1.price}"/> 

</h :co1umn> 

< h:co1umn > 

<f:facet name="header"> 

<h:outputText value="Address"/> 

</f:facet> 

<h:outputText value=" #{iteml.address}"/> 

</h :co1umn> 

< h:co1umn > 

<f : facet name = 11 header 11 > 

<h:outputText value="Product"/> 

</f:facet> 

<h:outputText value=" #{iteml.product}"/> 

</h :co1umn> 


To: 
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<title>Pet Catalog Items</tit1e> 
<hl>Pet Catalog Items</hl> 


< h : co1umn > 

<f : facet name="header"> 

<h : outputText va1ue = "Name"/> 

</f:facet> 

<h : outputText value = " #{item1.name}"/> 

</h :co1umn> 

< h : co1umn > 

<f : facet name="header"> 

<h : outputText va1ue = "Photo "/> 

</f:facet> 

< h : ou tpu tText value = " i tern 1 . image thumburl } 11 /> 

</h :co1umn> 

< h:co1umn > 

<f : facet name="header"> 

<h : outputText value = "Price"/> 

</f:facet> 


<h : outputText value = " #{item 1.price}"/> 

</h :co1umn> 


15. Deploy and run the project by right-clicking thepetcataiog project and then selecting Run. You can also click the Run 
Main Project (F6) icon ^ in the main toolbar or click the Run menu item. 

In response, the IDE saves all the changed files, rebuilds the application, starts the GlassFish v2UR2 application server, 

and deploys the application to the application server. Your default web browser opens to the URL 

http : //locaihost: 8080/petcataiog / and displays the Pet Catalog welcome page as shown in Figure 20. 


Pet Catalog 


Show All Product Items 

Show All Item Items 
Show All Category Items 

Show All Address Items 


Figure 20. Pet Catalog Welcome Page 


Try out some of the links. For example, if you click the "Show All Product Items" link, you should see the Catalog Products 
page shown in Figure 3. 

Summary 

GlassFish fully supports Java EE 5 web technologies, including dynamic web technologies such as JSP and JavaServer Faces 
technology. In addition, GlassFish has a built-in persistence manager, the Java Persistence API, and supports ease-of-use 
features such as annotations. These capabilities, combined with the simplicity of querying and manipulating MySQL databases, 
make it easy to build a web application with data persistence that accesses a MySQL database and deploy it on a GlassFish 
application server. The NetBeans IDE, which integrates MySQL and GlassFish, makes building these applications even easier. 

In the next article in this series, you'll see how easy it is to create a web application that accesses a web service through 
GlassFish's support for the Metro web services stack and updates a MySQL database. 

For More Information 

♦ GlassFish and MySQL, Part 1: A Perfect Combination For Web Applications 

♦ GlassFish and MySQL, Part 3: Creating and Using a Web Service 

♦ GlassFish and MySQL, Part 4: Creating a RESTful Web Service and JavaFX Client 

♦ MySQL 

♦ GlassFish 

♦ Java EE Technologies 

♦ The Aquarium 
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